home *** CD-ROM | disk | FTP | other *** search
/ LOGIC Apps / Logic-APPLE_II_APPS.iso / mac / LOGIC Apple II 5.25" Library - ProDOS / PRO044.dsk / DOS.MASTER.DOC.txt < prev    next >
Text File  |  2012-02-16  |  11KB  |  242 lines
  1.  
  2.                 DOS MASTER documentation
  3.  
  4.     DOS MASTER is a system for putting DOS 3.3 partitions on ProDOS
  5.     volumes such as a hard disk or a 3.5" disk.  I have been using
  6.     this system on my 20MB hard disk for over a year.
  7.  
  8.     The system will support DOS 3.3 on up to 4 different slots and
  9.     two drives/slot and up to 255 volumes/drive.  On each slot you
  10.     can have 560 sector, 800 sector or 1600 sector DOS volumes.
  11.     These are not intermixable, but different slots can support
  12.     different volume sizes.  The large 1600 sector size uses 32
  13.     sectors/track and thus may be incompatible with some DOS
  14.     utilities (eg., an unmodified FID will not work on such volumes
  15.     [but the supplied FUD program will]).  For this reason I personally
  16.     prefer the 800 sector size.  The 560 sector size is the standard
  17.     size of a DOS 3.3 floppy disk, and hence would be the most
  18.     compatible size to use.
  19.  
  20.     -------------------------------------------------------------------
  21.  
  22.     NOTICE
  23.  
  24.     The DOS MASTER system is Copyrighted 1987 by Glen E. Bredon.  All
  25.     rights reserved.
  26.  
  27.     This system is distributed as shareware.  If you use it, you are
  28.     asked to send a payment of $20 to the author:
  29.  
  30.             Glen E. Bredon
  31.             521 State Road
  32.             Princeton, NJ 08540
  33.  
  34.     Add $5 handling if you ask me to send a disk, and $5 more outside
  35.     the US and Canada.
  36.  
  37.     -------------------------------------------------------------------
  38.  
  39.     ADVANTAGES OF THIS SYSTEM
  40.  
  41.     (1)  The system lives peacefully on any ProDOS device.
  42.  
  43.     (2)  Partitions can be on both a hard disk and a 3.5 disk and are
  44.     compatible with one another as well as with standard DOS 3.3
  45.     floppies.
  46.  
  47.     (3)  The system uses no memory outside the standard DOS area.
  48.     Thus it should be compatible with damn near everything.
  49.  
  50.     -------------------------------------------------------------------
  51.  
  52.     DISADVANTAGES OF THIS SYSTEM
  53.  
  54.     The system patches over the DOS 3.3 formatter, so you cannot INIT
  55.     INIT a disk from it, or use a formatting function in any program
  56.     that has such a function.
  57.  
  58.     -------------------------------------------------------------------
  59.  
  60.     SETTING UP THE SYSTEM
  61.  
  62.     It will take some work to get the system set up the first time.
  63.     Here are detailed steps to follow:
  64.  
  65.     (1)  Short descriptions of the files on the supplied disk:
  66.  
  67.          DOS.MASTER.DOC (this doc file)
  68.          MAKE.DOS       (sets up user parameters and makes the
  69.                  DOS.3.3 file)
  70.          RDLINE         (a Basic added command used by MAKE.DOS)
  71.          DOS.MASTER     (a "template" used by MAKE.DOS)
  72.          DOS.INSTALL    (lays down the DOS partition on selected disks)
  73.          REVISE.DM      (a Basic program that allows modification of
  74.                  the DOS.3.3 program in case you change the
  75.                  hard disk slot.  Also lets you see all the
  76.                  supported slots and volume data that you put
  77.                  into the DOS.3.3 file when you ran MAKE.DOS)
  78.          RDLINE         (an added ProDOS command used by MAKE.DOS)
  79.  
  80.          The following are DOS 3.3 programs.  After setting DOS.MASTER
  81.          up, you can BRUN FUD and use it to transfer these (and other)
  82.          DOS 3.3 programs to your created DOS 3.3 partition.
  83.  
  84.          HELLO          (a little HELLO for the DOS volumes; it just
  85.                  does a CATALOG and displayes the number of
  86.                  free sectors on the current DOS volume)
  87.          FUD            (a DOS 3.3 filing utility fully compatible
  88.                  with the DOS MASTER.)
  89.  
  90.          (These files must be converted from ProDOS to a DOS 3.3 disk 
  91.          using CONVERT or COPY ][+.)
  92.  
  93.     (3)  Boot into ProDOS BASIC.SYSTEM.
  94.  
  95.          Decide how many devices you are going to want supported,
  96.          and put ProDOS disks in all of them (there is no point
  97.          supporting 5.25 devices - they are automatically supported
  98.          by the system).  Decide how many DOS volumes per device,
  99.          and how large you want them.  (Eg, think about how much
  100.          space they will take; for example 10 800 sector volumes
  101.          is 4000 ProDOS blocks large, and the ProSel Backup program
  102.          will backup all those blocks.  Do you really want that many?)
  103.  
  104.     (4)  Run the BASIC program called MAKE.DOS.
  105.  
  106.          (a) The program expects the file DOS that you made in
  107.          step (2) to be on the disk MAKE.DOS was run from.
  108.          It also wants the file RDLINE to be there.
  109.  
  110.          (b) The program will ask for a slot to support.  Input 0
  111.          when done.  (Type ESC to abort the whole thing.)
  112.  
  113.          (c) The program will ask for the volume size for this
  114.          device.  It will use the same size for both drives
  115.          on that slot (if there are two).
  116.  
  117.          (d) The program will tell you the maximum number of DOS
  118.          volumes that that slot will support, and ask for how
  119.          many you want on drive 1.
  120.  
  121.          (e) The program will ask the same question for drive 2.
  122.          (CAUTION: DOS MASTER expects the ProDOS volume size
  123.          to be the SAME for drive 1 and drive 2 of any given
  124.          slot.  This is not always the case.  If it is not the
  125.          case, then drive 2 cannot be supported.  The program
  126.          will not check for this.  You MUST defeat drive 2 in
  127.          this case by selecting 0 DOS volumes at this prompt!)
  128.  
  129.          (f) The program will then return to item (b).  If you
  130.          type "0" in step (b) then the program will continue
  131.          to step (g):
  132.  
  133.          (g) The program will now create and write the file
  134.          DOS.3.3 on the disk it was run from.  This is the
  135.          only writing that this program does.  It needs formatted
  136.          disks in the supported devices for reading only, in
  137.          order to check some parameters.
  138.  
  139.  
  140.     (5)  Now you have the file DOS.3.3.  This is the file that
  141.          switches you to the DOS 3.3 partition whenever you
  142.          execute it.  It is a SYS file, and can be selected from
  143.          ProSel.  It supports the conventions in ProSel for
  144.          selecting UnoDOS, so you should review that.  Also it
  145.          supports booting into a particular volume.  It does this
  146.          by interpreting any number (in ascii) in the startup
  147.          after a semicolon to be the volume desired.  The filetype
  148.          of the program to be run (B or T) should follow this,
  149.          with Applesoft as the default.  The hello file name,
  150.          if any, should precede the semicolon; it defaults to
  151.          "HELLO".  (Incidently, the 800 sector option on 3.5"
  152.          disks is compatible with the ProSel UnoDOS.)
  153.  
  154.     (6)  However, you are not yet done setting everything up.
  155.          You must "install" a DOS 3.3 directory on the disks you
  156.          wish to put a DOS partition on.  This is done by the
  157.          DOS.INSTALL program.  DOS.INSTALL must be run from the
  158.          disk containing the DOS.3.3 file from step (4).  This
  159.          program will read the file DOS.3.3 to see what parameters
  160.          you set up in step (4).  It will ask you for a slot and
  161.          drive to put the DOS partition on.  You must have a
  162.          ProDOS FORMATTED disk in the appropriate drive.
  163.          The program will check this disk to see if it has room
  164.          for the partition you have selected.  If not, it will
  165.          abort before doing anything.  If so, it will proceed as
  166.          follows:  If the device is a 3.5 disk and you elected
  167.          volume size 800 and 4 volumes on the disk, or size 1600
  168.          and 2 volumes on the disk then (since these DOS volumes
  169.          will completely fill the disk leaving no ProDOS space)
  170.          you will be asked if you want to leave space to make the
  171.          disk "bootable".  If so, this will lock some DOS tracks
  172.          and release some corresponding ProDOS blocks to make
  173.          room for a couple of ProDOS files [see (7)].
  174.  
  175.          Then you are asked to hit RTN to proceed or ESC to abort.
  176.          If you hit RTN, the program will write the DOS partition
  177.          to the selected device.
  178.  
  179.     (7)  The DOS partition is now set up, and can be accessed by
  180.          running the DOS.3.3 program.  However, if you run that
  181.          from a device NOT containing a partition, it will give
  182.          an I/O error.  This is harmless and you can access the
  183.          device with a partition by typing CATALOG,S?,V?  with
  184.          the appropriate S and V parameters.
  185.  
  186.          To make the partitioned disk bootable, copy (from ProDOS)
  187.          the PRODOS (P8) file to the partitioned disk, and also
  188.          copy the file DOS.3.3 from step (4) there.  Then rename
  189.          DOS.3.3 to DOS.3.3.SYSTEM or any name ending in ".SYSTEM".
  190.          (Also rename P8 to PRODOS if it is not already called that.)
  191.          The "bootable" option leaves just enough room, with a
  192.          little extra, for these two ProDOS files.  The 560 sector
  193.          option, on 3.5" disks, already has sufficient ProDOS space
  194.          left over from the partition for these files (this option
  195.          has a maximum of 5 DOS volumes per 3.5" disk).
  196.  
  197.     (8)  At this step you can boot directly into the partitioned
  198.          disk.  However, you will get a FILE NOT FOUND error since
  199.          the boot has looked for a file called HELLO and no such
  200.          file is on the DOS partition.  You can write one, or use
  201.          the one provided with these files:
  202.  
  203.          To use the provided HELLO program, you must convert it
  204.          from ProDOS to a DOS 3.3 floppy using CONVERT or COPY II+.
  205.          (This is already done, and on the back of the disk if this
  206.          is a supplied disk and not a download.)  Then boot into
  207.          DOS 3.3 by booting a DOS disk, or by entering the DOS
  208.          partition by executing the DOS.3.3 program.  (Just type
  209.          -DOS.3.3 <RTN> from ProDOS BASIC.SYSTEM.)  Then run the
  210.          filing program FUD on the back of the disk and use it to
  211.          copy itself and any other DOS 3.3 programs you want, to
  212.          the DOS partition.  It is suggested that you at least
  213.          put a HELLO program, such as the one supplied, on Volume 1
  214.          since DOS.MASTER boots by default into the first volume.
  215.          You can boot into other volumes as described in step (9):
  216.  
  217.     (9)  As described in the ProSel doc for UnoDOS, you can go
  218.          directly from ProSel to any program on any of the DOS
  219.          volumes.  For example, if FUD is on volume 2 of the DOS
  220.          partition of the disk containing the DOS.3.3 ProDOS file,
  221.          then you make an application specification such as:
  222.  
  223.         Screen name:     FUD (DOS 3.3)
  224.         Prefix:          ?UTIL           (if DOS.3.3 is in UTIL)
  225.         Application:     DOS.3.3
  226.         Startup:         FUD;2B
  227.  
  228.          (The "2" in the startup specifies DOS volume 2 and the "B"
  229.          tells DOS.MASTER that FUD is a B-type {binary} file.)
  230.  
  231.          If there is no startup specification or DOS is booted
  232.          by the BASIC command -DOS.3.3 then it will attempt to
  233.          to boot into the same slot and drive that the DOS.3.3
  234.          program was in, and into volume 1 of the partition,
  235.          and will attempt to run the BASIC program called HELLO.
  236.  
  237.          If that slot/drive has no partition then an I/O error
  238.          will result - this is harmless.  If the partition exists
  239.          but no HELLO program (or the specified startup program)
  240.          exists on the booted DOS volume then a "FILE NOT FOUND"
  241.          error will result.
  242.